home *** CD-ROM | disk | FTP | other *** search
/ Freelog 15 / FREELOG 15.ISO / WebMaster / Perl / PERL5106.ZIP / perl5 / Lib / perl5db.pl < prev    next >
Encoding:
Perl Script  |  1995-12-02  |  15.4 KB  |  575 lines
  1. package DB;
  2.  
  3. # modified Perl debugger, to be run from Emacs in perldb-mode
  4. # Ray Lischner (uunet!mntgfx!lisch) as of 5 Nov 1990
  5. # Johan Vromans -- upgrade to 4.0 pl 10
  6.  
  7. $header = '$RCSfile: perl5db.pl,v $$Revision: 4.1 $$Date: 92/08/07 18:24:07 $';
  8. #
  9. # This file is automatically included if you do perl -d.
  10. # It's probably not useful to include this yourself.
  11. #
  12. # Perl supplies the values for @line and %sub.  It effectively inserts
  13. # a &DB'DB(<linenum>); in front of every place that can
  14. # have a breakpoint.  It also inserts a do 'perldb.pl' before the first line.
  15. #
  16. # $Log:    perldb.pl,v $
  17.  
  18. require Config;
  19.  
  20. local($^W) = 0;
  21.  
  22. if (-e "/dev/tty") {
  23.     $console = "/dev/tty";
  24.     $rcfile=".perldb";
  25. }
  26. elsif (-e "con" || ( $Config::Config{osname} eq 'MSWin32' ) ) {
  27.     $console = "con";
  28.     $rcfile="perldb.ini";
  29. } 
  30. else {
  31.     $console = "sys\$command";
  32.     $rcfile="perldb.ini";
  33. }
  34.  
  35. open(IN, "<$console") || open(IN,  "<&STDIN");    # so we don't dingle stdin
  36. open(OUT,">$console") || open(OUT, ">&STDERR")
  37.     || open(OUT, ">&STDOUT");    # so we don't dongle stdout
  38. select(OUT);
  39. $| = 1;                # for DB::OUT
  40. select(STDOUT);
  41. $| = 1;                # for real STDOUT
  42. $sub = '';
  43.  
  44. # Is Perl being run from Emacs?
  45. $emacs = $main::ARGV[0] eq '-emacs';
  46. shift(@main::ARGV) if $emacs;
  47.  
  48. $header =~ s/.Header: ([^,]+),v(\s+\S+\s+\S+).*$/$1$2/;
  49. print OUT "\nLoading DB routines from $header\n";
  50. print OUT ("Emacs support ",
  51.        $emacs ? "enabled" : "available",
  52.        ".\n");
  53. print OUT "\nEnter h for help.\n\n";
  54.  
  55. @ARGS;
  56.  
  57. sub DB {
  58.     &save;
  59.     ($pkg, $filename, $line) = caller;
  60.     $usercontext = '($@, $!, $,, $/, $\, $^W) = @saved;' .
  61.     "package $pkg;";        # this won't let them modify, alas
  62.     local(*dbline) = "::_<$filename";
  63.     $max = $#dbline;
  64.     if (($stop,$action) = split(/\0/,$dbline{$line})) {
  65.     if ($stop eq '1') {
  66.         $signal |= 1;
  67.     }
  68.     else {
  69.         $evalarg = "\$DB::signal |= do {$stop;}"; &eval;
  70.         $dbline{$line} =~ s/;9($|\0)/$1/;
  71.     }
  72.     }
  73.     if ($single || $trace || $signal) {
  74.     if ($emacs) {
  75.         print OUT "\032\032$filename:$line:0\n";
  76.     } else {
  77.         $prefix = $sub =~ /'|::/ ? "" : "${pkg}::";
  78.         $prefix .= "$sub($filename:";
  79.         if (length($prefix) > 30) {
  80.         print OUT "$prefix$line):\n$line:\t",$dbline[$line];
  81.         $prefix = "";
  82.         $infix = ":\t";
  83.         }
  84.         else {
  85.         $infix = "):\t";
  86.         print OUT "$prefix$line$infix",$dbline[$line];
  87.         }
  88.         for ($i = $line + 1; $i <= $max && $dbline[$i] == 0; ++$i) {
  89.         last if $dbline[$i] =~ /^\s*(}|#|\n)/;
  90.         print OUT "$prefix$i$infix",$dbline[$i];
  91.         }
  92.     }
  93.     }
  94.     $evalarg = $action, &eval if $action;
  95.     if ($single || $signal) {
  96.     $evalarg = $pre, &eval if $pre;
  97.     print OUT $#stack . " levels deep in subroutine calls!\n"
  98.         if $single & 4;
  99.     $start = $line;
  100.       CMD:
  101.     while ((print OUT "  DB<", $#hist+1, "> "), $cmd=&gets) {
  102.         {
  103.         $single = 0;
  104.         $signal = 0;
  105.         $cmd eq '' && exit 0;
  106.         chop($cmd);
  107.         $cmd =~ s/\\$// && do {
  108.             print OUT "  cont: ";
  109.             $cmd .= &gets;
  110.             redo CMD;
  111.         };
  112.         $cmd =~ /^q$/ && exit 0;
  113.         $cmd =~ /^$/ && ($cmd = $laststep);
  114.         push(@hist,$cmd) if length($cmd) > 1;
  115.         ($i) = split(/\s+/,$cmd);
  116.         eval "\$cmd =~ $alias{$i}", print OUT $@ if $alias{$i};
  117.         $cmd =~ /^h$/ && do {
  118.             print OUT "
  119. T        Stack trace.
  120. s        Single step.
  121. n        Next, steps over subroutine calls.
  122. r        Return from current subroutine.
  123. c [line]    Continue; optionally inserts a one-time-only breakpoint 
  124.         at the specified line.
  125. <CR>        Repeat last n or s.
  126. l min+incr    List incr+1 lines starting at min.
  127. l min-max    List lines.
  128. l line        List line;
  129. l        List next window.
  130. -        List previous window.
  131. w line        List window around line.
  132. l subname    List subroutine.
  133. f filename    Switch to filename.
  134. /pattern/    Search forwards for pattern; final / is optional.
  135. ?pattern?    Search backwards for pattern.
  136. L        List breakpoints and actions.
  137. S        List subroutine names.
  138. t        Toggle trace mode.
  139. b [line] [condition]
  140.         Set breakpoint; line defaults to the current execution line; 
  141.         condition breaks if it evaluates to true, defaults to \'1\'.
  142. b subname [condition]
  143.         Set breakpoint at first line of subroutine.
  144. d [line]    Delete breakpoint.
  145. D        Delete all breakpoints.
  146. a [line] command
  147.         Set an action to be done before the line is executed.
  148.         Sequence is: check for breakpoint, print line if necessary,
  149.         do action, prompt user if breakpoint or step, evaluate line.
  150. A        Delete all actions.
  151. V [pkg [vars]]    List some (default all) variables in package (default current).
  152. X [vars]    Same as \"V currentpackage [vars]\".
  153. < command    Define command before prompt.
  154. > command    Define command after prompt.
  155. ! number    Redo command (default previous command).
  156. ! -number    Redo number\'th to last command.
  157. H -number    Display last number commands (default all).
  158. q or ^D        Quit.
  159. p expr        Same as \"print DB::OUT expr\" in current package.
  160. = [alias value]    Define a command alias, or list current aliases.
  161. command        Execute as a perl statement in current package.
  162.  
  163. ";
  164.             next CMD; };
  165.         $cmd =~ /^t$/ && do {
  166.             $trace = !$trace;
  167.             print OUT "Trace = ".($trace?"on":"off")."\n";
  168.             next CMD; };
  169.         $cmd =~ /^S$/ && do {
  170.             foreach $subname (sort(keys %sub)) {
  171.             print OUT $subname,"\n";
  172.             }
  173.             next CMD; };
  174.         $cmd =~ s/^X\b/V $pkg/;
  175.         $cmd =~ /^V$/ && do {
  176.             $cmd = "V $pkg"; };
  177.         $cmd =~ /^V\b\s*(\S+)\s*(.*)/ && do {
  178.             local ($savout) = select(OUT);
  179.             $packname = $1;
  180.             @vars = split(' ',$2);
  181.             do 'dumpvar.pl' unless defined &main::dumpvar;
  182.             if (defined &main::dumpvar) {
  183.             &main::dumpvar($packname,@vars);
  184.             }
  185.             else {
  186.             print DB::OUT "dumpvar.pl not available.\n";
  187.             }
  188.             select ($savout);
  189.             next CMD; };
  190.         $cmd =~ /^f\b\s*(.*)/ && do {
  191.             $file = $1;
  192.             if (!$file) {
  193.             print OUT "The old f command is now the r command.\n";
  194.             print OUT "The new f command switches filenames.\n";
  195.             next CMD;
  196.             }
  197.             if (!defined $main::{'_<' . $file}) {
  198.             if (($try) = grep(m#^_<.*$file#, keys %main::)) {
  199.                 $file = substr($try,2);
  200.                 print "\n$file:\n";
  201.             }
  202.             }
  203.             if (!defined $main::{'_<' . $file}) {
  204.             print OUT "There's no code here anything matching $file.\n";
  205.             next CMD;
  206.             }
  207.             elsif ($file ne $filename) {
  208.             *dbline = "::_<$file";
  209.             $max = $#dbline;
  210.             $filename = $file;
  211.             $start = 1;
  212.             $cmd = "l";
  213.             } };
  214.         $cmd =~ /^l\b\s*([':A-Za-z_][':\w]*)/ && do {
  215.             $subname = $1;
  216.             $subname = "main::" . $subname unless $subname =~ /'|::/;
  217.             $subname = "main" . $subname if substr($subname,0,1)eq "'";
  218.             $subname = "main" . $subname if substr($subname,0,2)eq "::";
  219.             ($file,$subrange) = split(/:/,$sub{$subname});
  220.             if ($file ne $filename) {
  221.             *dbline = "::_<$file";
  222.             $max = $#dbline;
  223.             $filename = $file;
  224.             }
  225.             if ($subrange) {
  226.             if (eval($subrange) < -$window) {
  227.                 $subrange =~ s/-.*/+/;
  228.             }
  229.             $cmd = "l $subrange";
  230.             } else {
  231.             print OUT "Subroutine $1 not found.\n";
  232.             next CMD;
  233.             } };
  234.         $cmd =~ /^w\b\s*(\d*)$/ && do {
  235.             $incr = $window - 1;
  236.             $start = $1 if $1;
  237.             $start -= $preview;
  238.             $cmd = 'l ' . $start . '-' . ($start + $incr); };
  239.         $cmd =~ /^-$/ && do {
  240.             $incr = $window - 1;
  241.             $cmd = 'l ' . ($start-$window*2) . '+'; };
  242.         $cmd =~ /^l$/ && do {
  243.             $incr = $window - 1;
  244.             $cmd = 'l ' . $start . '-' . ($start + $incr); };
  245.         $cmd =~ /^l\b\s*(\d*)\+(\d*)$/ && do {
  246.             $start = $1 if $1;
  247.             $incr = $2;
  248.             $incr = $window - 1 unless $incr;
  249.             $cmd = 'l ' . $start . '-' . ($start + $incr); };
  250.         $cmd =~ /^l\b\s*(([\d\$\.]+)([-,]([\d\$\.]+))?)?/ && do {
  251.             $end = (!$2) ? $max : ($4 ? $4 : $2);
  252.             $end = $max if $end > $max;
  253.             $i = $2;
  254.             $i = $line if $i eq '.';
  255.             $i = 1 if $i < 1;
  256.             if ($emacs) {
  257.             print OUT "\032\032$filename:$i:0\n";
  258.             $i = $end;
  259.             } else {
  260.             for (; $i <= $end; $i++) {
  261.                 print OUT "$i:\t", $dbline[$i];
  262.                 last if $signal;
  263.             }
  264.             }
  265.             $start = $i;    # remember in case they want more
  266.             $start = $max if $start > $max;
  267.             next CMD; };
  268.         $cmd =~ /^D$/ && do {
  269.             print OUT "Deleting all breakpoints...\n";
  270.             for ($i = 1; $i <= $max ; $i++) {
  271.             if (defined $dbline{$i}) {
  272.                 $dbline{$i} =~ s/^[^\0]+//;
  273.                 if ($dbline{$i} =~ s/^\0?$//) {
  274.                 delete $dbline{$i};
  275.                 }
  276.             }
  277.             }
  278.             next CMD; };
  279.         $cmd =~ /^L$/ && do {
  280.             for ($i = 1; $i <= $max; $i++) {
  281.             if (defined $dbline{$i}) {
  282.                 print OUT "$i:\t", $dbline[$i];
  283.                 ($stop,$action) = split(/\0/, $dbline{$i});
  284.                 print OUT "  break if (", $stop, ")\n" 
  285.                 if $stop;
  286.                 print OUT "  action:  ", $action, "\n" 
  287.                 if $action;
  288.                 last if $signal;
  289.             }
  290.             }
  291.             next CMD; };
  292.         $cmd =~ /^b\b\s*([':A-Za-z_][':\w]*)\s*(.*)/ && do {
  293.             $subname = $1;
  294.             $cond = $2 || '1';
  295.             $subname = "${pkg}::" . $subname
  296.             unless $subname =~ /'|::/;
  297.             $subname = "main" . $subname if substr($subname,0,1) eq "'";
  298.             $subname = "main" . $subname if substr($subname,0,2) eq "::";
  299.             ($filename,$i) = split(/:/, $sub{$subname});
  300.             $i += 0;
  301.             if ($i) {
  302.             *dbline = "::_<$filename";
  303.             ++$i while $dbline[$i] == 0 && $i < $#dbline;
  304.             $dbline{$i} =~ s/^[^\0]*/$cond/;
  305.             } else {
  306.             print OUT "Subroutine $subname not found.\n";
  307.             }
  308.             next CMD; };
  309.         $cmd =~ /^b\b\s*(\d*)\s*(.*)/ && do {
  310.             $i = ($1?$1:$line);
  311.             $cond = $2 || '1';
  312.             if ($dbline[$i] == 0) {
  313.             print OUT "Line $i not breakable.\n";
  314.             } else {
  315.             $dbline{$i} =~ s/^[^\0]*/$cond/;
  316.             }
  317.             next CMD; };
  318.         $cmd =~ /^d\b\s*(\d+)?/ && do {
  319.             $i = ($1?$1:$line);
  320.             $dbline{$i} =~ s/^[^\0]*//;
  321.             delete $dbline{$i} if $dbline{$i} eq '';
  322.             next CMD; };
  323.         $cmd =~ /^A$/ && do {
  324.             for ($i = 1; $i <= $max ; $i++) {
  325.             if (defined $dbline{$i}) {
  326.                 $dbline{$i} =~ s/\0[^\0]*//;
  327.                 delete $dbline{$i} if $dbline{$i} eq '';
  328.             }
  329.             }
  330.             next CMD; };
  331.         $cmd =~ /^<\s*(.*)/ && do {
  332.             $pre = action($1);
  333.             next CMD; };
  334.         $cmd =~ /^>\s*(.*)/ && do {
  335.             $post = action($1);
  336.             next CMD; };
  337.         $cmd =~ /^a\b\s*(\d+)(\s+(.*))?/ && do {
  338.             $i = $1;
  339.             if ($dbline[$i] == 0) {
  340.             print OUT "Line $i may not have an action.\n";
  341.             } else {
  342.             $dbline{$i} =~ s/\0[^\0]*//;
  343.             $dbline{$i} .= "\0" . action($3);
  344.             }
  345.             next CMD; };
  346.         $cmd =~ /^n$/ && do {
  347.             $single = 2;
  348.             $laststep = $cmd;
  349.             last CMD; };
  350.         $cmd =~ /^s$/ && do {
  351.             $single = 1;
  352.             $laststep = $cmd;
  353.             last CMD; };
  354.         $cmd =~ /^c\b\s*(\d*)\s*$/ && do {
  355.             $i = $1;
  356.             if ($i) {
  357.             if ($dbline[$i] == 0) {
  358.                 print OUT "Line $i not breakable.\n";
  359.                 next CMD;
  360.             }
  361.             $dbline{$i} =~ s/(\0|$)/;9$1/;    # add one-time-only b.p.
  362.             }
  363.             for ($i=0; $i <= $#stack; ) {
  364.             $stack[$i++] &= ~1;
  365.             }
  366.             last CMD; };
  367.         $cmd =~ /^r$/ && do {
  368.             $stack[$#stack] |= 2;
  369.             last CMD; };
  370.         $cmd =~ /^T$/ && do {
  371.             local($p,$f,$l,$s,$h,$a,@a,@sub);
  372.             for ($i = 1; ($p,$f,$l,$s,$h,$w) = caller($i); $i++) {
  373.             @a = ();
  374.             for $arg (@args) {
  375.                 $_ = "$arg";
  376.                 s/'/\\'/g;
  377.                 s/([^\0]*)/'$1'/
  378.                 unless /^(?: -?[\d.]+ | \*[\w:]* )$/x;
  379.                 s/([\200-\377])/sprintf("M-%c",ord($1)&0177)/eg;
  380.                 s/([\0-\37\177])/sprintf("^%c",ord($1)^64)/eg;
  381.                 push(@a, $_);
  382.             }
  383.             $w = $w ? '@ = ' : '$ = ';
  384.             $a = $h ? '(' . join(', ', @a) . ')' : '';
  385.             push(@sub, "$w$s$a from file $f line $l\n");
  386.             last if $signal;
  387.             }
  388.             for ($i=0; $i <= $#sub; $i++) {
  389.             last if $signal;
  390.             print OUT $sub[$i];
  391.             }
  392.             next CMD; };
  393.         $cmd =~ /^\/(.*)$/ && do {
  394.             $inpat = $1;
  395.             $inpat =~ s:([^\\])/$:$1:;
  396.             if ($inpat ne "") {
  397.             eval '$inpat =~ m'."\a$inpat\a";    
  398.             if ($@ ne "") {
  399.                 print OUT "$@";
  400.                 next CMD;
  401.             }
  402.             $pat = $inpat;
  403.             }
  404.             $end = $start;
  405.             eval '
  406.             for (;;) {
  407.             ++$start;
  408.             $start = 1 if ($start > $max);
  409.             last if ($start == $end);
  410.             if ($dbline[$start] =~ m'."\a$pat\a".'i) {
  411.                 if ($emacs) {
  412.                 print OUT "\032\032$filename:$start:0\n";
  413.                 } else {
  414.                 print OUT "$start:\t", $dbline[$start], "\n";
  415.                 }
  416.                 last;
  417.             }
  418.             } ';
  419.             print OUT "/$pat/: not found\n" if ($start == $end);
  420.             next CMD; };
  421.         $cmd =~ /^\?(.*)$/ && do {
  422.             $inpat = $1;
  423.             $inpat =~ s:([^\\])\?$:$1:;
  424.             if ($inpat ne "") {
  425.             eval '$inpat =~ m'."\a$inpat\a";    
  426.             if ($@ ne "") {
  427.                 print OUT "$@";
  428.                 next CMD;
  429.             }
  430.             $pat = $inpat;
  431.             }
  432.             $end = $start;
  433.             eval '
  434.             for (;;) {
  435.             --$start;
  436.             $start = $max if ($start <= 0);
  437.             last if ($start == $end);
  438.             if ($dbline[$start] =~ m'."\a$pat\a".'i) {
  439.                 if ($emacs) {
  440.                 print OUT "\032\032$filename:$start:0\n";
  441.                 } else {
  442.                 print OUT "$start:\t", $dbline[$start], "\n";
  443.                 }
  444.                 last;
  445.             }
  446.             } ';
  447.             print OUT "?$pat?: not found\n" if ($start == $end);
  448.             next CMD; };
  449.         $cmd =~ /^!+\s*(-)?(\d+)?$/ && do {
  450.             pop(@hist) if length($cmd) > 1;
  451.             $i = ($1?($#hist-($2?$2:1)):($2?$2:$#hist));
  452.             $cmd = $hist[$i] . "\n";
  453.             print OUT $cmd;
  454.             redo CMD; };
  455.         $cmd =~ /^!(.+)$/ && do {
  456.             $pat = "^$1";
  457.             pop(@hist) if length($cmd) > 1;
  458.             for ($i = $#hist; $i; --$i) {
  459.             last if $hist[$i] =~ $pat;
  460.             }
  461.             if (!$i) {
  462.             print OUT "No such command!\n\n";
  463.             next CMD;
  464.             }
  465.             $cmd = $hist[$i] . "\n";
  466.             print OUT $cmd;
  467.             redo CMD; };
  468.         $cmd =~ /^H\b\s*(-(\d+))?/ && do {
  469.             $end = $2?($#hist-$2):0;
  470.             $hist = 0 if $hist < 0;
  471.             for ($i=$#hist; $i>$end; $i--) {
  472.             print OUT "$i: ",$hist[$i],"\n"
  473.                 unless $hist[$i] =~ /^.?$/;
  474.             };
  475.             next CMD; };
  476.         $cmd =~ s/^p( .*)?$/print DB::OUT$1/;
  477.         $cmd =~ /^=/ && do {
  478.             if (local($k,$v) = ($cmd =~ /^=\s*(\S+)\s+(.*)/)) {
  479.             $alias{$k}="s~$k~$v~";
  480.             print OUT "$k = $v\n";
  481.             } elsif ($cmd =~ /^=\s*$/) {
  482.             foreach $k (sort keys(%alias)) {
  483.                 if (($v = $alias{$k}) =~ s~^s\~$k\~(.*)\~$~$1~) {
  484.                 print OUT "$k = $v\n";
  485.                 } else {
  486.                 print OUT "$k\t$alias{$k}\n";
  487.                 };
  488.             };
  489.             };
  490.             next CMD; };
  491.         }
  492.         $evalarg = $cmd; &eval;
  493.         print OUT "\n";
  494.     }
  495.     if ($post) {
  496.         $evalarg = $post; &eval;
  497.     }
  498.     }
  499.     ($@, $!, $,, $/, $\, $^W) = @saved;
  500.     ();
  501. }
  502.  
  503. sub save {
  504.     @saved = ($@, $!, $,, $/, $\, $^W);
  505.     $, = ""; $/ = "\n"; $\ = ""; $^W = 0;
  506. }
  507.  
  508. # The following takes its argument via $evalarg to preserve current @_
  509.  
  510. sub eval {
  511.     eval "$usercontext $evalarg; &DB::save";
  512.     print OUT $@;
  513. }
  514.  
  515. sub action {
  516.     local($action) = @_;
  517.     while ($action =~ s/\\$//) {
  518.     print OUT "+ ";
  519.     $action .= &gets;
  520.     }
  521.     $action;
  522. }
  523.  
  524. sub gets {
  525.     local($.);
  526.     <IN>;
  527. }
  528.  
  529. sub catch {
  530.     $signal = 1;
  531. }
  532.  
  533. sub sub {
  534.     push(@stack, $single);
  535.     $single &= 1;
  536.     $single |= 4 if $#stack == $deep;
  537.     if (wantarray) {
  538.     @i = &$sub;
  539.     $single |= pop(@stack);
  540.     @i;
  541.     }
  542.     else {
  543.     $i = &$sub;
  544.     $single |= pop(@stack);
  545.     $i;
  546.     }
  547. }
  548.  
  549. $trace = $signal = $single = 0;    # uninitialized warning suppression
  550.  
  551. @hist = ('?');
  552. $SIG{'INT'} = "DB::catch";
  553. $deep = 100;        # warning if stack gets this deep
  554. $window = 10;
  555. $preview = 3;
  556.  
  557. @stack = (0);
  558. @ARGS = @ARGV;
  559. for (@args) {
  560.     s/'/\\'/g;
  561.     s/(.*)/'$1'/ unless /^-?[\d.]+$/;
  562. }
  563.  
  564. if (-f $rcfile) {
  565.     do "./$rcfile";
  566. }
  567. elsif (-f "$ENV{'LOGDIR'}/$rcfile") {
  568.     do "$ENV{'LOGDIR'}/$rcfile";
  569. }
  570. elsif (-f "$ENV{'HOME'}/$rcfile") {
  571.     do "$ENV{'HOME'}/$rcfile";
  572. }
  573.  
  574. 1;
  575.